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ABOUT THIS CHAPTER 


Note: The Sound Manager is a replacement for the Sound Driver documented in 
this chapter. The abilities of the Sound Driver are currently supported 
by the Sound Manager and it will utilize future hardware improvements. 
The Sound Manager offers more flexible ways of doing things and includes 
new features and options, all requiring less programming effort. This 
chapter on the Sound Driver is included for reference; however, Apple 
highly recommends that you use the Sound Manager, documented in the 
Sound Manager chapter, instead of the Sound Driver in your applications. 


The Sound Driver is a Macintosh device driver for handling sound and music 
generation in a Macintosh application. This chapter describes the Sound Driver 
in detail. 


You should already be familiar with: 


* events, as discussed in the Toolbox Event Manager chapter 

e the Memory Manager 

« the use of devices and device drivers, as described in 
the Device Manager chapter 
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ABOUT THE SOUND DRIVER 


The Sound Driver is a standard Macintosh device driver in ROM that's used to 
synthesize sound. You can generate sound characterized by any kind of waveform 
by using the three different sound synthesizers in the Sound Driver: 


¢ The four-tone synthesizer is used to make simple harmonic tones, with up 
to four "voices" producing sound simultaneously; it requires about 50% of 
the microprocessor's attention during any given time interval. 

e The square-wave synthesizer is used to produce less harmonic sounds such 
as beeps, and requires about 2% of the processor's time. 

¢ The free-form synthesizer is used to make complex music and speech; it 
requires about 20% of the processor's time. 


The Macintosh XL is equipped only with a square-wave synthesizer; all 
information in this chapter about four-tone and free-form sound applies only to 
the Macintosh 128K and 512K. 


Figure 1 depicts the waveform of a typical sound wave, and the terms used to 
describe it. The magnitude is the vertical distance between any given point on 
the wave and the horizontal line about which the wave oscillates; you can think 
of the magnitude as the volume level. The amplitude is the maximum magnitude of 
a periodic wave. The wavelength is the horizontal extent of one complete cycle 
of the wave. Magnitude and wavelength can be measured in any unit of distance. 
The period is the time elapsed during one complete cycle of a wave. The 
frequency is the reciprocal of the period, or the number of cycles per 
second—also called hertz (Hz). The phase is some fraction of a wave cycle 
(measured from a fixed point on the wave). 


There are many different types of waveforms, three of which are depicted in 
Figure 2. Sine waves are generated by objects that oscillate periodically at a 
Single frequency (such as a tuning fork). Square waves are generated by objects 
that toggle instantly between two states at a single frequency (Such as an 
electronic "beep"). Free-form waves are the most common of all, and are 
generated by objects that vibrate at rapidly changing frequencies with rapidly 
changing magnitudes (such as your vocal cords). 
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Figure 2—Types of Waveforms 


Figure 3 shows analog and digital representations of a waveform. The Sound 
Driver represents waveforms digitally, so all waveforms must be converted from 
their analog representation to a digital representation. The rows of numbers at 
the bottom of the figure are digital representations of the waveform. The 
numbers in the upper row are the magnitudes relative to the horizontal zero- 
magnitude line. The numbers in the lower row all represent the same relative 
magnitudes, but have been normalized to positive numbers; you'll use numbers 
like these when calling the Sound Driver. 


A digital representation of a waveform is simply a sequence of wave magnitudes 
measured at fixed intervals. This sequence of magnitudes is stored in the Sound 
Driver as a sequence of bytes, each one of which specifies an instantaneous 
voltage to be sent to the speaker. The bytes are stored in a data structure 
called a waveform description. Since a sequence of bytes can only represent a 
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Figure 3—Analog and Digital Representations of a Waveform 
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SOUND DRIVER SYNTHESIZERS 


A description of the sound to be generated by a synthesizer is contained in a 
data structure called a synthesizer buffer. A synthesizer buffer contains the 
duration, pitch, phase, and waveform of the sound the synthesizer will generate. 
The exact structure of a synthesizer buffer differs for each type of synthesizer 
being used. The first word in every synthesizer buffer is an integer that 
identifies the synthesizer, and must be one of the following predefined 
constants: 


CONST swMode = -1; {square-wave synthesizer} 
ftMode = 1; {four-tone synthesizer} 
ffMode = 0; {free-form synthesizer} 


Square-Wave Synthesizer 


The square-wave synthesizer is used to make sounds such as beeps. A square-wave 
synthesizer buffer has the following structure: 


TYPE SWSynthRec = RECORD 


mode: INTEGER; {always swMode} 
triplets: Tones {sounds} 
END; 
SWSynthPtr = “SWSynthRec; 
Tones = ARRAY[Q..5000] OF Tone; 
Tone = RECORD 
count: INTEGER; {frequency} 


amplitude: INTEGER; famplitude, 0-255} 
duration: INTEGER {duration in ticks} 
END; 


Each tone triplet contains the count, amplitude, and duration of a different 
sound. You can store as many triplets in a synthesizer buffer as there's room 
for. 


The count integer can range in value from @ to 65535. The actual frequency the 
count corresponds to is given by the relationship: 


frequency (Hz) = 783360 / count 


A partial list of count values and corresponding frequencies for notes is given 
in the summary at the end of this chapter. 


The type Tones is declared with 5001 elements to allow you to pass up to 5000 
sounds (the last element must contain 0). To be space-efficient, your 
application shouldn't declare a variable of type Tones; instead, you can do 
something like this: 
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VAR myPtr: Ptr; 
myHandle: Handle; 
mySwWPtr: SWSynthPtr; 


myHandle := NewHandle(buffSize) ; {allocate space for the buffer} 
HLock(myHandlLe) ; {lock the buffer} 

myPtr := myHandle’; {dereference the handle} 
mySwWPtr := SWSynthPtr(myPtr) ; {coerce type to SWSynthPtr} 
mySWPtr*.mode := swMode; {identify the synthesizer} 
mySWPtr*.triplets[Q].count := 2; {fill the buffer with values } 


iets Ag { describing the sound} 
StartSound(myPtr,buffSize,POINTER(-1)); {produce the sound} 
HUnlock(myHandle) {unlock the buffer} 


where buffSize contains the number of bytes in the synthesizer buffer. This 
example dereferences handles instead of using pointers directly, to minimize the 
number of nonrelocatable objects in the heap. 


Assembly-language note: The global variable CurPitch contains the current 
value of the count field. 


The amplitude can range from 0 to 255. The duration specifies the number of 
ticks that the sound will be generated. 


The list of tones ends with a triplet in which all fields are set to 0. When the 
square-wave synthesizer is used, the sound specified by each triplet is 
generated once, and then the synthesizer stops. 


Four-Tone Synthesizer 

The four-tone synthesizer is used to produce harmonic sounds such as music. It 
can simultaneously generate four different sounds, each with its own frequency, 
phase, and waveform. 

A four-tone synthesizer buffer has the following structure: 


TYPE FTSynthRec = RECORD 


mode: INTEGER; {always ftMode} 
sndRec: FTSndRecPtr {tones to play} 
END; 


FTSynthPtr = *FTSynthRec; 
The sndRec field points to a four-tone record, which describes the four tones: 


TYPE FTSoundRec = RECORD 


duration: INTEGER; {duration in ticks} 
sound1Rate: Fixed; {tone 1 cycle rate} 
soundiPhase: LONGINT; {tone 1 byte offset} 
sound2Rate: Fixed; {tone 2 cycle rate} 
sound2Phase: LONGINT; {tone 2 byte offset} 
sound3Rate: Fixed; {tone 3 cycle rate} 
sound3Phase: LONGINT; {tone 3 byte offset} 
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sound4Rate: Fixed; {tone 4 cycle rate} 
sound4Phase: LONGINT; {tone 4 byte offset} 
sound1Wave: WavePtr; {tone 1 waveform} 
sound2Wave: WavePtr; {tone 2 waveform} 
sound3Wave: WavePtr; {tone 3 waveform} 
sound4Wave: WavePtr {tone 4 waveform} 
END; 

FTSndRecPtr = “FTSoundRec: 

Wave = PACKED ARRAY[0..255] OF Byte; 

WavePtr = “Wave; 


Assembly-language note: The address of the four-tone record currently in use 
is stored in the global variable SoundPtr. 


The duration integer indicates the number of ticks that the sound will be 
generated. Each phase long integer indicates the byte within the waveform 
description at which the synthesizer should begin producing sound (the first 
byte is byte number 0). Each rate value determines the speed at which the 
synthesizer cycles through the waveform, from @ to 255. 


The four-tone synthesizer creates sound by starting at the byte in the waveform 
description specified by the phase, and skipping ahead the number of bytes 
specified by the rate field every 44.93 microseconds; when the time specified by 
the duration has elapsed, the synthesizer stops. The rate field determines how 
the waveform will be "sampled", as shown in Figure 4. For nonperiodic waveforms, 
this is best illustrated by example: If the rate field is 1, each byte value in 
the waveform will be used, each producing sound for 44.93 microseconds. If the 
rate field is 0.1, each byte will be used 10 times, each therefore producing 
sound for a total of 449.3 microseconds. If the rate field is 5, only every 
fifth byte in the waveform will be sampled, each producing sound for 44.93 
microseconds. 


If the waveform contains one wavelength, the frequency that the rate corresponds 
to is given by: 


frequency (Hz) = 1000000 / (44.93 / (rate/256) ) 


You can use the Toolbox Utility routines FixMul and FixRatio to calculate this, 
as follows: 


frequency := FixMul (rate, FixRatio(22257,256) ) 


The maximum rate of 256 corresponds to approximately 22.3 kilohertz if the 
waveform contains one wavelength, and a rate of 0 produces no sound. A partial 
list of rate values and corresponding frequencies for notes is given in the 
summary at the end of this chapter. 


Free-Form Synthesizer 


The free-form synthesizer is used to synthesize complex music and speech. The 
sound to be produced is represented as a waveform whose complexity and length 
are Limited only by available memory. 
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A free-form synthesizer buffer has the following structure: 


TYPE FFSynthRec = RECORD 


mode: INTEGER; {always ffMode} 
count: Fixed; {"sampling" factor} 
waveBytes: FreeWave {waveform description} 
END; 
FFSynthPtr = *“FFSynthRec; 
FreeWave = PACKED ARRAY[0..30000] OF Byte; 


The type FreeWave is declared with 30001 elements to allow you to pass a very 
long waveform. To be space-efficient, your application shouldn't declare a 
variable of type FreeWave; instead, you can do something like this: 


VAR myPtr: Ptr; 
myHandle: Handle; 
myFFPtr: FFSynthPtr; 


myHandle = NewHandle(buffSize); {allocate space for the buffer} 


HLock(myHandlLe) ; {lock the buffer} 

myPtr := myHandle’; {dereference the handle} 
myFFPtr := FFSynthPtr(myPtr) ; {coerce type to FFSynthPtr} 
myFFPtr*.mode := ffMode; {identify the synthesizer} 
myFFPtr*.count := FixRatio(1,1); {fill the buffer with values } 
myFFPtr*.waveBytes[0] := 0; { describing the sound} 


StartSound(myPtr, buffSize, POINTER(—1)); {produce the sound} 
HUnlock(myHandle) {unlock the buffer} 


where buffSize contains the number of bytes in the synthesizer buffer. This 
example dereferences handles instead of using pointers directly, to minimize the 
number of nonrelocatable objects in the heap. 
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Figure 4-Effect of the Rate Field 
The free-form synthesizer creates sound by starting at the first byte in the 
waveform and skipping ahead the number of bytes specified by count every 44.93 
microseconds. The count field determines how the waveform will be "sampled"; 
it's analogous to the rate field of the four-tone synthesizer (see Figure 4 
above). When the end of the waveform is reached, the synthesizer will stop. 


For periodic waveforms, you can determine the frequency of the wave cycle by 
using the following relationship: 


frequency (Hz) = 1000000 / (44.93 * (wavelength/count) ) 
You can calculate this with Toolbox Utility routines as follows: 


frequency := FixMul (count, FixRatio(22257,wavelength) ) 
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The wavelength is given in bytes. For example, the frequency of a wave with a 
100-byte wavelength played at a count value of 2 would be approximately 445 Hz. 
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USING THE SOUND DRIVER 


The Sound Driver is opened automatically when the system starts up. Its driver 
name is '.Sound', and its driver reference number is —4. To close or open the 

Sound Driver, you can use the Device Manager Close and Open functions. Because 
the driver is in ROM, there's really no reason to close it. 


To use one of the three types of synthesizers to generate sound, you can do the 
following: Use the Memory Manager function NewHandle to allocate heap space for 
a synthesizer buffer; then lock the buffer, fill it with values describing the 
sound, and make a StartSound call to the Sound Driver. StartSound can be called 
either synchronously or asynchronously (with an optional completion routine). 
When called synchronously, control returns to your application after the sound 
is completed. When called asynchronously, control returns to your application 
immediately, and your application is free to perform other tasks while the sound 
is produced. 


To produce continuous, unbroken sounds, it's sometimes advantageous to 
preallocate space for all the synthesizer buffers you require before you make 
the first StartSound call. Then, while one asynchronous StartSound call is being 
completed, you can calculate the waveform values for the next call. 


To avoid the click that may occur between StartSound calls when using the four- 
tone synthesizer, set the duration field to a large value and just change the 
value of one of the rate fields to start a new sound. To avoid the clicks that 
may occur during four-tone and free-form sound generation, fill the waveform 
description with multiples of 740 bytes. 


Warning: The Sound Driver uses interrupts to produce sound. If other device 
drivers are in use, they may turn off interrupts, making sound 
production unreliable. For instance, if the Disk Driver is accessing 
a disk during sound generation, a "crackling" sound may be produced. 


To determine when the sound initiated by a StartSound call has been completed, 
you can poll the SoundDone function. You can cancel any current StartSound call 
and any pending asynchronous StartSound calls by calling StopSound. By calling 
GetSoundVol and SetSoundVol, you can get and set the current speaker volume 
level. 
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SOUND DRIVER ROUTINES 


PROCEDURE StartSound (synthRec: Ptr; numBytes: LONGINT; 
completionRtn: ProcPtr); [Not in ROM] 


Assembly-language note: StartSound is equivalent to a Device Manager Write 
call with ioRefNum=—4, ioBuffer=synthRec, and 
ioReqCount=numBytes. 


StartSound begins producing the sound described by the synthesizer buffer 
pointed to by synthRec. NumBytes indicates the size of the synthesizer buffer 
(in bytes), and completionRtn points to a completion routine to be executed when 
the sound finishes: 


¢ If completionRtn is POINTER(-1), the sound will be produced synchronously. 

¢ If completionRtn is NIL, the sound will be produced asynchronously, but 
no completion routine will be executed. 

e Otherwise, the sound will be produced asynchronously and the routine 
pointed to by completionRtn will be executed when the sound finishes. 


Warning: You may want the completion routine to start the next sound when one 
sound finishes, but beware: Completion routines are executed at the 
interrupt level and must preserve all registers other than AO, Al, 
and DO-D2. They must not make any calls to the Memory Manager, 
directly or indirectly, and can't depend on handles to unlocked 
blocks being valid; be sure to preallocate all the space you'll need. 
Or, instead of starting the next sound itself, the completion routine 
can post an application-defined event and your application's main 
event loop can start the next sound when it gets the event. 


Because the type of pointer for each type of synthesizer buffer is different and 
the type of the synthRec parameter is Ptr, you'll need to do something like the 
following example (which applies to the free-form synthesizer): 


VAR myPtr: Ptr; 
myHandle: Handle; 
myFFPtr: FFSynthPtr; 


myHandle = NewHandle(buffSize); {allocate space for the buffer} 


HLock(myHandlLe) ; {lock the buffer} 
myPtr := myHandle’; {dereference the handle} 
myFFPtr := FFSynthPtr(myPtr) ; {coerce type to FFSynthPtr} 


myFFPtr*.mode := ffMode; {identify the synthesizer} 

a ae a {fill the buffer with values } 
{ describing the sound} 

StartSound(myPtr,buffSize,POINTER(-1)); {produce the sound} 

HUnlock(myHandle) {unlock the buffer} 


where buffSize is the number of bytes in the synthesizer buffer. 


The sounds are generated as follows: 
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« Free-form synthesizer: The magnitudes described by each byte in the 
waveform description are generated sequentially until the number of bytes 
specified by the numBytes parameter have been written. 

¢ Square-wave synthesizer: The sounds described by each sound triplet are 
generated sequentially until either the end of the buffer has been reached 
(indicated by a count, amplitude, and duration of 0 in the square-wave 
buffer), or the number of bytes specified by the numBytes parameter have 
been written. 

¢ Four-tone synthesizer: All four sounds are generated for the length of 
time specified by the duration integer in the four-tone record. 


PROCEDURE StopSound; [Not in ROM] 


StopSound immediately stops the current StartSound call (if any), executes the 
current StartSound call's completion routine (if any), and cancels any pending 
asynchronous StartSound calls. 


Assembly-language note: To stop sound from assembly language, you can make a 
Device Manager KillIO call (and, when using the 
square-wave synthesizer, set the global variable 
CurPitch to 0). Although StopSound executes the 
completion routine of only the current StartSound 
call, KillIO executes the completion routine of every 
pending asynchronous call. 


FUNCTION SoundDone : BOOLEAN; [Not in ROM] 


SoundDone returns TRUE if the Sound Driver isn't currently producing sound and 
there are no asynchronous StartSound calls pending; otherwise it returns FALSE. 


Assembly-language note: Assembly-language programmers can poll the ioResult 
field of the most recent Device Manager Write call's 
parameter block to determine when the Write call 
finishes. 


PROCEDURE GetSoundVol (VAR level: INTEGER); [Not in ROM] 
GetSoundVol returns the current speaker volume, from 0 (silent) to 7 (loudest). 


Assembly-language note: Assembly-language programmers can get the speaker 
volume level from the low-order three bits of the 
global variable SdVolume. 


PROCEDURE SetSoundVol (level: INTEGER); [Not in ROM] 


SetSoundVol immediately sets the speaker volume to the specified level, from 0 
(silent) to 7 (loudest); it doesn't, however, change the volume setting that's 
under user control via the Control Panel desk accessory. If your application 
calls SetSoundVol, it should save the current volume (using GetSoundVol) when it 
starts up and restore it (with SetSoundVol) upon exit; this resets the actual 
speaker volume to match the Control Panel setting. 


Assembly-language note: To set the speaker volume level from assembly 
language, call this Pascal procedure from your program. 
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Note: 


As a side effect, it will set the low-order three bits 
of the global variable SdVolume to the specified level. 


The Control Panel volume setting is stored in parameter RAM; if you're 
writing a similar desk accessory and want to change this setting, see 


the discussion of parameter RAM in the Operating System Utilities 
chapter. 
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SOUND DRIVER HARDWARE 


The information in this section applies to the Macintosh 128K and 512K, but not 
the Macintosh XL. 


This section briefly describes how the Sound Driver uses the Macintosh hardware 
to produce sound, and how assembly-language programmers can intervene in this 
process to control the square-wave synthesizer. You can skip this section if it 
doesn't interest you, and you'll still be able to use the Sound Driver as 
described. 


Note: For more information about the hardware used by the Sound Driver, see 
the Macintosh Hardware chapter. 


The Sound Driver and disk speed-control circuitry share a special 740-byte 
buffer in memory, of which the Sound Driver uses the 370 even-numbered bytes to 
generate sound. Every horizontal blanking interval (every 44.93 
microseconds—when the beam of the display tube moves from the right edge of the 
screen to the left), the MC68000 automatically fetches two bytes from this 
buffer and sends the high-order byte to the speaker. 


Note: The period of any four-tone or free-form sound generated by the Sound 
Driver is a multiple of this 44.93-microsecond interval; the highest 
frequency is 11128 Hz, which corresponds to twice this interval. 


Every vertical blanking interval (every 16.6 milliseconds—when the beam of the 
display tube moves from the bottom of the screen to the top), the Sound Driver 
fills its half of the 740-byte buffer with the next set of values. For square- 
wave sound, the buffer is filled with a constant value; for more complex sound, 
it's filled with many values. 


From assembly language, you can cause the square-wave synthesizer to start 
generating sound, and then change the amplitude of the sound being generated any 
time you wish: 


1. Make an asynchronous Device Manager Write call to the Sound Driver 
specifying the count, amplitude, and duration of the sound you want. 
The amplitude you specify will be placed in the 740-byte buffer, and 
the Sound Driver will begin producing sound. 

2. Whenever you want to change the sound being generated, make an immediate 
Control call to the Sound Driver with the following parameters: ioRefNum 
must be —4, csCode must be 3, and csParam must provide the new amplitude 
level. The amplitude you specify will be placed in the 740-byte buffer, 
and the sound will change. You can continue to change the sound until the 
time specified by the duration has elapsed. 


When the immediate Control call is completed, the Device Manager will execute 
the completion routine (if any) of the currently executing Write call. For this 
reason, the Write call shouldn't have a completion routine. 


Note: You can determine the amplitude placed in the 740-byte buffer from the 
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global variable SoundLevel. 
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SUMMARY OF THE SOUND DRIVER 


Constants 
CONST 


{ Mode values for synthesizers } 


swMode = -1; {square-wave synthesizer} 
ftMode = 1 {four-tone synthesizer} 
ffMode = 0; {free-form synthesizer} 
Data Types 
TYPE 


{ Free-form synthesizer } 


FFSynthPtr = *“FFSynthRec; 
FFSynthRec = RECORD 
mode: INTEGER; {always ffMode} 
count: Fixed; {"sampling" factor} 
waveBytes: FreeWave {waveform description} 
END; 
FreeWave = PACKED ARRAY[0..30000] OF Byte; 


{ Square-wave synthesizer } 


SWSynthPtr = *“SWSynthRec; 
SWSynthRec = RECORD 
mode: INTEGER; {always swMode} 
triplets: Tones {sounds} 
END; 
Tones = ARRAY[@..5000] OF Tone; 
Tone = RECORD 
count: INTEGER; {frequency} 


amplitude: INTEGER; famplitude, 0-255} 
duration: INTEGER {duration in ticks} 
END; 


{ Four-tone synthesizer } 


FTSynthPtr = *FTSynthRec; 
FTSynthRec = RECORD 
mode: INTEGER; {always ftMode} 
sndRec: FTSndRecPtr {tones to play} 
END; 
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FTSndRecPtr = *“FTSoundRec: 
FTSoundRec = RECORD 


duration: INTEGER; {duration in ticks} 
sound1Rate: Fixed; {tone 1 cycle rate} 
soundiPhase: LONGINT; {tone 1 byte offset} 
sound2Rate: Fixed; {tone 2 cycle rate} 
sound2Phase: LONGINT; {tone 2 byte offset} 
sound3Rate: Fixed; {tone 3 cycle rate} 
sound3Phase: LONGINT; {tone 3 byte offset} 
sound4Rate: Fixed; {tone 4 cycle rate} 
sound4Phase: LONGINT; {tone 4 byte offset} 
sound1Wave: WavePtr; {tone 1 waveform} 
sound2Wave: WavePtr; {tone 2 waveform} 
sound3Wave: WavePtr; {tone 3 waveform} 
sound4Wave: WavePtr {tone 4 waveform} 
END; 
WavePtr = “Wave; 
Wave = PACKED ARRAY[0..255] OF Byte; 
Routines 


PROCEDURE StartSound (synthRec: Ptr; numBytes: LONGINT; 
completionRtn: ProcPtr); 

PROCEDURE StopSound; 

FUNCTION SoundDone : BOOLEAN; 

PROCEDURE GetSoundVol (VAR level: INTEGER); 

PROCEDURE SetSoundVol (level: INTEGER); 


Assembly-Language Information 
Routines 
Pascal name Equivalent for assembly language 


StartSound Call Write with ioRefNum=—4, ioBuffer=synthRec, 
ioReqCount=numBytes 

StopSound Call KillIO and (for square-wave) set CurPitch to 0 

SoundDone Poll ioResult field of most recent Write call's parameter block 

GetSoundVol Get low-order three bits of variable SdVolume 

SetSoundVol Call this Pascal procedure from your program 


Variables 

SdVolume Speaker volume (byte: low-order three bits only) 
SoundPtr Pointer to four-tone record 

SoundLevel Amplitude in 740-byte buffer (byte) 

CurPitch Value of count in square-wave synthesizer buffer (word) 
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Sound Driver Values for Notes 


The following table contains values for the rate field of a four-tone 
synthesizer and the count field of a square-wave synthesizer. A just-tempered 
scale—in the key of C, as an example—is given in the first four columns; you can 
use a just-tempered scale for perfect tuning in a particular key. The last four 
columns give an equal-tempered scale, for applications that may use any key; 
this scale is appropriate for most Macintosh sound applications. Following this 
table is a list of the ratios used in calculating these values, and instructions 
on how to calculate them for a just-tempered scale in any key. 


Just-Tempered Scale Equal-Tempered Scale 
Rate for Count for Rate for Count for 
Four-Tone Square-Wave Four-Tone Square-Wave 
Note Long Fixed Word Integer Long Fixed Word Integer 


3 octaves below middle C 


C 612B 0.37956 5CBA 23738 604C 0.37616 5D92 23954 
C# 667C 0.40033 57EB 22507 6606 0.39853 5851 22609 
Db 67A6 0.40488 56EF 22255 
D 6D51 0.42702 526D 21101 6C17 0.42223 535C 21340 
Ebb 6E8F 0.43187 5180 20864 
D# 71DF 0.44481 4F21 20257 7284 0.44733 4EAF 20143 
Eb 749A 0.45547 4D46 19782 
E 7976 0.47446 4A2F 18991 7953 0.47392 4A44 19012 
F 818F 0.50609 458C 17804 808A 0.50211 4619 17945 
F# 88A5 0.53377 41F0 16880 882F 0.53197 422A 16938 
Gb 8A32 0.53983 4133 16691 
G 91C1 0.56935 3DD1 15825 9048 0.56360 3E73 15987 
G# 97D4 0.59308 3B58 15192 98DC 0.59711 BAF2 15090 
Ab 9B79 0.60732 39F4 14836 
A A1F3 0.63261 37A3 14243 A1F3 0.63261 37A3 14243 
Bbb A3CA 0.63980 3703 14083 
A# AAOC 0.66425 34FD 13565 AB94 0.67023 3484 13444 
Bb ACBF 0.67479 3429 13353 
B B631 0.71169 3174 12660 B5C8 0.71008 3191 12689 


2 octaves below middle C 


C C257 0.75914 2E5D 11869 C097 0.75230 2EC9 11977 
C# CCF8 0.80066 2BF6 11254 CCOB 0.79704 2C29 11305 
Db CF4C 0.80975 2B77 11127 

D DAA2 0.85403 2936 10550 D82D 0.84444 29AE 10670 
Ebb DD1D 0.86372 28C0 10432 

D# E3BE 0.88962 2790 10128 E508 0.89465 2757 10071 
Eb E935 0.91096 26A3 9891 

E F2ED 0.94893 2517 9495 F2A6 0.94785 2522 9506 
F 1031E 1.01218 22C6 8902 10114 1.00421 230C 8972 
F# 1114A 1.06754 20F8 8440 1105D 1.06392 2115 8469 
Gb 11465 1.07967 2099 8345 

G 12382 1.13870 1EE9 7913 12090 1.12720 1F3A 7994 


@ SpInside Macintosh * Version 1.0 * November 1989 * Apple Computer 
THE SOUND DRIVER « 20 of 24 


2 octaves below middle C 


G# 12FA8 1.18616 1DAC 7596 131B8 1.19421 1D79 7545 
Ab 136F1 1.21461 1CFA 7418 
A 143E6 1.26523 1BD1 7121 143E6 1.26523 1BD1 7121 
Bobb 14794 1.27960 1B81 7041 
A# 15418 1.32849 1LA7E 6782 15729 1.34047 1A42 6722 
Bb 1597E 1.34958 1A14 6676 
B 16C63 1.42339 18BA 6330 16B90 1.42017 18C8 6344 


1 octave below middle C 


C 184AE 1.51828 172F 5935 1812F 1.50462 1764 5988 
C# 199EF 1.60130 15FB 5627 19816 1.59409 1614 5652 
Db 19E97 1.61949 15BC 5564 

D 1B543 1.70805 149B 5275 1B05A 1.68887 14D7 5335 
Ebb 1BA3B 1.72746 1460 5216 

D# 1€77B 1.77922 13C8 5064 1CA10 1.78931 13AC 5036 
Eb 1D26A 1.82193 1351 4945 

E 1E5D9 1.89784 128C 4748 1E54D 1.89571 1291 4753 
F 2063D 2.02437 1163 4451 20228 2.00842 1186 4486 
F# 22294 2.13507 107C 4220 220BB 2.12785 108A 4234 
Gb 228C9 2.15932 104D 4173 

G 24704 2.27740 F74 3956 2411F 2.25438 FOD 3997 
G# 25F4F 2.37230 ED6 3798 26370 2.38843 EBC 3772 
Ab 26DE3 2.42924 E7D 3709 

A 287CC 2.53046 DEQ 3561 287CC 2.53046 DEQ 3561 
Bobb = 28F28 2.55920 DC1 3521 

A# 2A830 2.65698 D3F 3391 2AE51 2.68092 D21 3361 
Bb 2B2FC 2.69916 DOA 3338 

B 2D8C6 2.84677 C5D 3165 2D721 2.84035 C64 3172 
Middle C 

C 3095B 3.03654 B97 2967 3025D 3.00923 BB2 2994 
C# 333DE 3.20261 AFD 2813 3302C 3.18817 BOA 2826 
Db 33D2E 3.23898 ADE 2782 

D 36A87 3.41612 A4E 2638 360B5 3.37776 A6C 2668 
Ebb 37476 3.45493 A30 2608 

D# 38EF7 3.55846 9E4 2532 39420 3.57861 9D6 2518 
Eb 3A4D4 3.64386 9A9 2473 

E 3CBB2 3.79568 946 2374 3CA99 3.79140 949 2377 
F 40C7A 4.04874 8B1 2225 40450 4.01685 8C3 2243 
F# 44528 4.27014 83E 2110 44176 4.25571 845 2117 
Gb 45193 4.31865 826 2086 

G 48E09 4.55482 7BA 1978 4823E 4.50876 7CE 1998 
G# 4BE9F 4.74461 76B 1899 4C6E1 4.77687 75E 1886 
Ab 4DBC5 4.85847 73F 1855 

A 50F98 5.06091 6F4 1780 50F98 5.06091 6F4 1780 
Middle C 

Bobb 51E4F 5.11839 6E0 1760 

A# 55060 5.31396 6A0 1696 55CA2 5.36185 690 1680 
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Bb 565F8 5.39832 685 1669 
B 5B18B 5.69353 62F 1583 5AE41 5.68068 632 1586 


1 octave above middle C 


C 612B7 6.07310 5CC 1484 604BB 6.01848 5D9 1497 
C# 667BD 6.40523 57F 1407 66059 6.37636 585 1413 
Db 67A5C 6.47797 56F 1391 
D 6D50D 6.83223 527 1319 6C169 6.75551 536 1334 
Ebb 6E8EB 6.90984 518 1304 
D# 71DEE 7.11691 4F2 1266 7283F 7.15721 4EB 1259 
Eb 749A8 7.28772 4D4 1236 
E 79764 7.59137 4A3 1187 79533 7.58281 4A4 1188 
F 818F3 8.09746 459 1113 808A1 8.03371 462 1122 
F# 88A51 8.54030 41F 1055 882EC 8.51141 423 1059 
Gb 8A326 8.63730 413 1043 
G 91C12 9.10965 3DD 989 9047D 9.01753 3E7 999 
G# 97D3D 9.48921 3B6 950 98DC2 9.55374 3AF 943 
Ab 9B78B 9.71696 39F 927 
A A1F30 = =10.12183 37A 890 A1F30 = 10.12183 37A 890 
Bbb A3C9F 10.23680 370 880 
A# AAOBF 10.62791 350 848 AB945 = =-:10.72371 348 840 
Bb ACBEF 10.79662 343 835 
B B6316 = =11.38705 317 791 B5C83—s- 11. 36137 319 793 


2 octaves above middle C 


C C256D) 12.14619 2E6 742 C0976 12.03696 2ED 749 
C# CCF79 12.81044 2BF 703 CCOB1 12.75270 2C3 707 
Db CF4B9 12.95595 2B7 695 
D DAA1B = =13.66447 293 659 D82D2 13.51102 29B 667 
Ebb DD1D6 13.81967 28C 652 
D# E3BDC 14. 23383 279 633 E507E 14.31442 275 629 
Eb E9350 14.57544 26A 618 
E F2EC8 15.18274 251 593 F2A65 15.16560 252 594 
F 1031E7 16.19493 22C 556 101141 16.06740 231 561 
F# 1114A1 17.08058 210 528 1105D8 17.02283 211 529 
Gb 11464C 17.27460 20A 522 
G 123824 18.21930 1LEF 495 1208F9 18.03505 1F4 500 
G#  12FA7B 18.97844 1DB 475 131B83 19.10747 1D8 472 
Ab = 136F15 19.43391 1D0 464 
A 143E61 20.24367 1BD 445 143E61 20.24367 1BD 445 
Bobb 14793D 20.47359 1B8 440 
A# 15417F 21.25584 1A8 424 15728A 21.44742 1A4 420 
Bb 1597DE 21.59323 1A1 417 
B 16C62D) =. 22..77412 18C 396 16B906 22.72275 18D 397 


3 octaves above middle C 


C 184ADA 24.29239 173 371 1812EB 24.07390 176 374 
C#  199EF2 25.62088 160 352 198163 25.50542 161 353 
Db 19E971 25.91188  15C 348 
D 1B5436 27.32895 14A 330 1BQ5A5 27.02205 14D 333 
Ebb 1BA3AC 27.63934 146 326 
D#  1C77B8 28.46765 13D 317 1CAOQFD 28.62886 13B 315 
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Eb 1D26A0 29.15088 135 309 


E 1E5D91 30.36549 129 297 1E54CB = 30.33122 129 297 
F 2063CE 32.38986 116 278 202283 32.13481 118 280 
FH 222943 34.16118 108 264 220BAF 34.04564 109 265 
Gb = 228C97 34.54918 105 261 
G 247047 36.43858 F7 247 2411F2 36.07010 FA 250 
G#  25F4F5 37.95686 ~~ ED 237 263706 38.21494 EC 236 
Ab 26DE2A 38.86783 £8 232 
A 287CC1 40.48732 DF 223 287CC1 40.48732 DF 223 
Bobb 28F27A 40.94717 DC 220 
A# 2A82FE 42.51169 D4 212 2AE513 42.89482 D2 210 
Bb 2B2FBD 43.18648 D1 209 
B 2D8C59 45.54823 C6 198 2D720B 45.44548 C6 198 


The following table gives the ratios used in calculating the above values. It 
shows the relationship between the notes making up the just-tempered scale in 
the key of C; should you need to implement a just-tempered scale in some other 
key, you can do so as follows: First get the value of the root note in the 
proper octave in the equal-tempered scale (from the above table). Then use the 
following table to determine the values of the intervals for the other notes in 
the key by multiplying the ratio by the root note. 


Chromatic Just-tempered Equal -tempered 
interval Note frequency ratio frequency ratio Interval type 


0 C 1.00000 1.00000 Unison 
1 C# 1.05469 1.05946 Minor second as chromatic 
semitone 
Db 1.06667 Minor second as diatonic 
semitone 
2 D 1.11111 1.12246 Major second as minor tone 
D 1.12500 Major second as major tone 
Ebb 1.13778 Diminished third 
3 D# 1.17188 1.18921 Augmented second 
Eb 1.20000 Minor third 
4 E 1.25000 1.25992 Major third 
5 F 1.33333 1.33484 Fourth 
6 F# 1.40625 1.41421 Tritone as augmented fourth 
Gb 1.42222 Tritone as diminished fifth 
7 G 1.50000 1.49831 Fifth 
8 G# 1.56250 1.58740 Augmented fifth 
Ab 1.60000 Minor sixth 
9 A 1.66667 1.68179 Major sixth 
Bbb 1.68560 Diminished seventh 
10 A# 1.75000 1.78180 Augmented sixth 
Bb 1.77778 Minor seventh 
11 B 1.87500 1.88775 Major seventh 
12 C 2.00000 2.00000 Octave 
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Further Reference: 


Sound Manager 

Toolbox Event Manager 

Memory Manager 

Device Manager 

"Macintosh Family Hardware Reference" 


END OF DOCUMENT 
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